home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / datatypes / aiffdt / aiff.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  5KB  |  100 lines
  1. @database AIFF.guide
  2. @author "Olaf `Olsen' Barthel"
  3. @$VER: AIFF.guide 1.1 (25.11.94)
  4. @node Main "AIFF sound datatype"
  5.                    AIFF Sound DataType for Workbench 3.0
  6.                       Written by Olaf `Olsen' Barthel
  7.                                Public Domain
  8.                             I.   @{" Introduction " link Introduction}
  9.                             II.  @{" Installation " link Installation}
  10.                             III. @{" Features     " link Features}
  11.                             IV.  @{" Bugs         " link Bugs}
  12.                             V.   @{" Author       " link Author}
  13.                             VI.  @{" History      " link History}
  14. @endnode
  15. @node Introduction
  16. "AIFF" is an acronym for "Audio Interchange File Format". This file format
  17. was devised by Apple Computer, Inc. and a number of third party developers
  18. and is mostly used on Apple Computers, such as the notorious Apple II,
  19. Apple IIGS and the Apple Macintosh. With the introduction of System 7 the
  20. Sound Manager was enhanced to support direct playback of "AIFF" and "AIFC"
  21. format files, thus making this file format an integral part of the
  22. Macintosh operating system. Most digital sound recording software on the
  23. Apple Macintosh supports "AIFF" as the native sound file format. Recently,
  24. "AIFF" was adopted for use with Kodak Portfolio CDs since the corresponding
  25. development software is largely Macintosh-based.
  26. "AIFF" and its `sister format' "AIFC" are in many ways similar to the
  27. "8SVX" IFF format which is commonly used on the Amiga. Both are stored in
  28. IFF format, can contain sampled sound data and offer means to store musical
  29. instrument data. Unlike "8SVX" it provides additional services, such as MIDI
  30. support, data markers and audio recording information. Sampled sound data
  31. is stored interleaved for multiple channels, making it easy to replay
  32. stereo sound. Samples do not need to be eight bits wide, such as required
  33. by the "8SVX" format. In fact, they can be anything from 1-32 bits wide.
  34. While both "AIFF" and "AIFC" share the IFF file structure and thus are
  35. designed as interchangeable file formats to be used on many computer
  36. platforms Apple Computer, Inc. added data compression support to "AIFC". As
  37. always, all the standard data compression methods are based upon
  38. proprietary algorithms to which Apple Computer, Inc. probably holds patents
  39. and is unwilling to share. In essence, this restricts the portability of
  40. compressed "AIFC" files.
  41. @endnode
  42. @node Installation
  43. The "AIFF" datatype distribution should consist of the following files:
  44.  aiff.datatype
  45.  AIFF
  46.  AIFF.info
  47.  AIFF.guide
  48.  AIFF.guide.info
  49.  Source code, in archived form
  50. Copy the file "aiff.datatype" into the "SYS:Classes/DataTypes" drawer. The
  51. "AIFF" and "AIFF.info" files should be placed in the "DEVS:DataTypes"
  52. drawer. In order to use the datatype you will need to reboot the machine.
  53. @endnode
  54. @node Features
  55. The "AIFF" datatype can read and process both "AIFF" and "AIFC" format
  56. files which include sampled sound data. In the case of "AIFC" files the
  57. sound data needs to be stored in uncompressed format.
  58. Sound samples will be cropped to eight bits per sample, stereo and
  59. multichannel data will be added up to yield monophonic sound.
  60. In order to compensate for memory shortages or sound replay rates the Amiga
  61. sound hardware would be unable to support the quality of the sound may get
  62. scaled down.
  63. In order to make the sound use the full dynamic amplitude range the sound
  64. data is normalized after loading.
  65. @endnode
  66. @node Bugs
  67. When running under Workbench 3.0, sounds larger than approximately 102400
  68. bytes will not play correctly. This is actually not a fault of the
  69. macsnd.datatype, but rather of the sound.datatype superclass which does no
  70. double-buffering. Application software can, however, easily compensate for
  71. this limitation.
  72. @endnode
  73. @node Author
  74. The "AIFF" datatype was written by Olaf `Olsen' Barthel using SAS/C 6.51.
  75. In order to recompile it you will need the Includes Release 40.15 or
  76. later. The datatype, the documentation and the accompanying source code are
  77. placed in the public domain.
  78. The author can be reached at:
  79.    Olaf Barthel
  80.    Brabeckstra
  81.    D-30559 Hannover
  82.    Federal Republic of Germany
  83. or via Internet:
  84.    olsen@sourcery.han.de
  85. @endnode
  86. @node History
  87. v1.11
  88. The sound reader could trash 1-3 bytes following the allocated sample
  89. data, this has been fixed. The reader now uses Martin Taillefer's
  90. asyncio routines which I modified slightly for reentrancy. I also
  91. added a new routine which this datatype does not yet need.
  92. v1.10
  93. Small changes to the sound normalization code.
  94. This release no longer requires v40, but you may still experience problems when
  95. running under v39. See the section entitled @{"Bugs" link Bugs} for more information. There is
  96. no longer so much stack space required to use this datatype. If necessary it
  97. will allocate new stack memory for itself and use it. Older releases could
  98. slightly distort the sound while normalizing it, this has been fixed.
  99. @endnode
  100.